home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / tools / dvpt2.exe / VRMOD.DOC < prev    next >
Encoding:
Text File  |  1991-12-12  |  3.1 KB  |  103 lines
  1.                Digitized Voice Programmer's Toolkit for the PC
  2.                -----------------------------------------------
  3.  
  4.                                Version 2.0
  5.  
  6.              Copyright (c) 1988,1989,1990,1991 Farpoint Software
  7.  
  8.                    Recording Procedure Call Documentation
  9.  
  10. ------------------------------------------------------------------------------
  11.  
  12. Calibration routine
  13. -------------------
  14.  
  15. Prototype:
  16.  
  17. long pascal far RCALIBRATE(void);
  18.  
  19.  
  20. This must be called once before RECORDVOICE is called. RECORDVOICE may be
  21. called multiple times thereafter, as long as the program remains in memory.
  22.  
  23.  
  24. Return value:
  25.  
  26. Low word      Meaning
  27. --------      -------
  28.    0          success
  29.    1          this CPU is too slow to accomplish normal-speed playback
  30.    2          operation not possible under Microsoft Windows
  31.                in "Enhanced" mode
  32.  
  33. The return value high word is the actual speed calibration constant for this
  34. computer.
  35.  
  36.  
  37. ------------------------------------------------------------------------------
  38.  
  39. Force Calibration Routine
  40. -------------------------
  41.  
  42. Prototype:
  43.  
  44. void pascal far RSETCAL(unsigned int calfactor);
  45.  
  46.  
  47. Normally never used, this call can be used to set the internal calibration
  48. constant normally determined by the RCALIBRATE routine. A possible use for
  49. RSETCAL would be to alter the recording sample rate.
  50.  
  51.  
  52. There is no return value.
  53.  
  54.  
  55. ------------------------------------------------------------------------------
  56.  
  57. Recording Routine
  58. -----------------
  59.  
  60. Prototype:
  61.  
  62. long pascal far RECORDVOICE( unsigned char far *buffer,
  63.                              long bytecount,
  64.                              int comport );
  65.  
  66.  
  67. This routine actually performs the voice recording. The CPU will be fully
  68. occupied by this operation. Any keypress during playback will terminate the
  69. operation. The keystroke will still be in the BIOS keystroke buffer when
  70. RECORDVOICE returns. Note that literally ANY keyboard action, including key
  71. releases and shift keys, will be sufficient to end playback. There is also
  72. a "stop" switch on the digitizer board which may be used to terminate
  73. recording.
  74.  
  75. The pointer "buffer" passed to the routine will be treated as a huge pointer,
  76. with 64k segment boundaries taken care of automatically. Also, the "bytecount"
  77. parameter is a 32 bit number. Thus, the practical limit to the size of one
  78. contiguous block of data to be recorded is the amount of memory available to
  79. your program.
  80.  
  81.  
  82. The return value indicates the actual number of bytes recorded. This number
  83. will be less than "bytecount" unless the routine was allowed to run until
  84. the buffer was full.
  85.  
  86.  
  87. ------------------------------------------------------------------------------
  88.  
  89. Memory Available Routine
  90. ------------------------
  91.  
  92. Prototype:
  93.  
  94. long pascal far GETMEMAVAIL(void);
  95.  
  96.  
  97. This is just a convenient way to find out how much memory can be allocated
  98. from DOS, under the assumption that it will all be used to create the largest
  99. possible recording buffer.
  100.  
  101.  
  102. The return value is the number of bytes available.
  103.